The Information In this booklet will give you an insight Into the 
powers of the Commodore. If you are a new computer owner you 
should find the color computing section very Interesting. The more 
advanced user's will find the section on poises and peel<s very 
informative. Most examples require no previous computer experience. 
The function of this booklet Is more of a reference guide, than a 
tutorial. Every program sample has a complete description of how it 
works. The contents within contains information on most of the 
important functions of the Commodore computer. Most of the material 
is written so that the user can start computing their very first day, 
without spending hours reading hard to understand computer 
manuals. There are tips that everyone can use In the everyday use of 
their computer. An explanation of each example is Included to make it 
as clear as possible. Please refer to the Index for help In finding the 
information that interests you the most. 
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The following pages will take you step by step through some simple 
program examples. After each example there is an explanation of what 
the program is doing, if you are new to computing, PLEASE DO NOT 
OVER LOOK THIS PAGE. 



GETTING STARTED: It Is Important that you read and understand the 
following information as It will be used very frequently as you precede. 
NEW - The NEW command is used to clear the computer memory of 
any basic program currently In memory. The purpose is to start each 
new program without the possibility of unwanted data from the 
previous program in memory, from becoming part of the new program. 
The NEW command should be used before typing In any any program. 

CLEARING THE SCREEN - Holding the RUN/STOP key down and 
then pressing the RESTORE key will clear the screen. This will not 
destroy the program currently In memory, by typing the word LIST 
your program will be displayed again. You will find that this technique 
is useful when editing your programs. This procedure can be used to 
clear the display before using the command NEW. 

CURSOR KEYS - The cursor keys are two keys on the lower right hand 
side of the keyboard. These keys are marked with the letters CRSR, 
and arrows pointing up/down on one and left/right on the other. The 
key on the left will move the cursor down when pressed, and up when 
used with the SHIFT key. The cursor key on the right will move the 
cursor right when pressed, and left when used with the SHIFT key. It Is 
possible to move the cursor anywhere on the screen using these keys. 

RETURN KEY - The RETURN key is used to enter data into memory. 
When you type in a command, such as the NEW command, the 
computer cannot respond until the command is entered by pressing the 
RETURN key. All data is entered in this manner. After typing In a 
program line, pressing the RETURN key will enter it into memory. 

LINE NUMBERS - The computer has to read a sequential list of 
numbers that precede each program line. Without line numbers it 
would be impossible for the computer to follow the program. Line 
numbers are not required if you wish to enter commands that are to be 
executed immediately. NO line number can be higher than 63999. 
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KEYBOARD COLORS 



The Commodore computer has a total of sixteen colors. This section 
will explain some uses for these colors. The examples shown can be 
modified for your own programs or just for fun. There are three 
different methods to access color In a basic program. The f jrst of these 
methods, is direct keyboare input. Colors with values from to 7 are 
accessed by holding the CTRL key down and any number key from 1 
through 8. To access the values from 8 to IS hold down the Commo- 
dore key ( Ci ) and any number key from i through 8. 

CHART ON KEYBOARD LOCATION OF COLORS 
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Screen will display 



See Page 36. 



Screen will display 



See Page 36. 



Please type in the program example below and run it. Between each 
letter there is a space, insert any color using the chart above in thise 
spaces. 

10 print "YOUR NAME" (press return key) then type the word 
RUN (press return key>. 
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The next example will be a display of bolored bars. First an 
explanation of what reversed text is and iiow to turn it on. The flashing 
square displayed on the screen Is called the cursor. The cursor Is 
actually a matrix of pixels (small dots). The cursor has all of Its pixels 
turned on. The make up of each letter, number, or character Is 
produced, by turning on only those pixels' that correspond to that 
particular character. When the text is reversed, only those pixels that 
surround a particular character are turned on. To turn on the reverse 
mode, hold the CTRL key down and press the number nine key, 
everything typed will be displayed In reversed text. To turn reversed 
mode off, hold the CTRL key down and press the (zero) key. Please 
type in the following: 

IHold the run/stop key down then hit the restore key to clear the screen. 
STEP 1 . Hold the CTRL key down then press the number nine key. 
STEP 2. Type In any color using the chart on the previous page. 
STEP 3. Hold the space bar down until the colored bar is the desired 
length. 

STEP 4. Next type In a new color and repeat steps 2 and 3 until ail 
sixteen colors have been displayed. 

Please type In the following example of programing color from the 
keyboard. Each program line should be typed in then the RETURN key 
should be pressed to enter each line Into memory. 

10 A = (RND (0)*16-I-1:REM GENERATES RANDOIVI NUIVIBERS 
20X$ = l^iD$ ("SEE BELOW ",A,1):REM SEE EXPLANATION. 
30 PRINT SPC(A( X$;:REM SEE EXPLANATION BELOW 
40 PRINT "YOUR NAME":PRINT:REIVI PRINTS NAME THAN ONE 
BLANK LINE 

50 FOR D = 1 TO 50: NEXT D:REM COiy/IPUTER STOPS TO COUNT 
TO 50 

60 GOTO10:REM RETURN TO LINE 10 

EXPLANATION: Line 10 creates random numbers from 1 to 
sixteen. Line 20 the variable X$ equals the MID$ values. Between the 
quote marks are the sixteen colors. The method to type them in 
follows: First hold the CTRL key down and press every number key 
from 1 through 8, this gives you the first eight colors. Next hold down 
the COMMODORE dey and press the number keys 1 through 8 again 
this gives you all sixteen colors. The A after the last quote mark Is the 
value generated by the RND statement in line 10. Starting from the far 
left side of the quote marks the value in line 10 counts left to right each 
color until the value is reached. Then the 1 picks one color. EXAMPLE: 
SUPPOSE THE VALUE GENERATED IN LINE 10 IS 7, THEN THE 
COLOR CHOOSEN WOULD BE THE SEVENTH FROM THE LEFT 
(the color blue). Line 30-prlnts the number of spaces that are generated 
In line 10 then the color. Line 40 print your name In the color chosen 
In line 20 and one blank line. Line 50 displays line 40 to the count of 50. 
Line 60 starts the process over again until stoppmJ by holding down the 
RUN/STOP key then hitting the RESTORE key. 
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COLOR USING ASCII:- 

The next method to program In color Is the use of the ASCII values. 
The chart below shows the ASCII values for all sixteen colors. 



COLOR 


ASCII VALUE 


COLOR ASCII 


VALUE 


Black 


144 


Orange 


129 


White 


5 


Brown 


149 


Red 


28 


Light Red 


150 


Cyan 


159 


Dark Grey 


151 


Purple 


156 


Medium Grey 


152 


Green 


30 


Light Green 


153 


Blue 


31 


Light Blue 


154 


Yellow 


158 


Light Grey 


155 


Reverse On 


18 


Reverse Off 


146 



The following program is an example of using ASCII values to 
program color. It Is good programing practice to follow the steps below 
before starting to type in new program. Please type in the following: 
STEP 1. Type the word NEW (press the return key). 
STEP 2. Now hold the RUN /STOP key down and hit the RESTORE key 
to clear the screen. 

10 PRINT CHR$(147) : REM CLEARS THE SCREEN 

20 INPUT "CHOOSE ASCII COLOR VALUE";A : REM PLEASE DO 

NOT USE ANY NUMBER THAT IS NOT ON THE ASCII CHART 

30 PRINT CHR$(18) CHR$(A);" ": REM TURNS REVERSE ON 
THEN PRINTS TEN SPACES IN THE COLOR THAT IS INPUT 

IN LINE 20. 

40 FOR A = 1 to 1000 : NEXT A : REM THE COMPUTER COUNTS 
FROM 1 TO 1000 THEN CONTINUES 

50 GOTO20 : REM GOTO LINE 20 

NOTE: Press the return key after typing each program line. After 
typing the complete program in, type the word RUN then press the 
return key. The word REM and any word that follows Is an explanation 
of each line and has nothing to do with the program running, typing 
this In Is optional. The last method of color programing consists of 
putting values Into special memory locations of the computer that 
control the color. Before you continue to this last section of color 
computing, please take-a short review. 
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A. The Commodore has 16 colors. 

B. There are three methods to program with color: 

1. Direct from keyboard. 

2. ASCII values. 

3. Inserting color values In memory. 

C. The cursor Is a matrix of pixels with the shape of a square. 

D. A pixel Is a small dot. 

E. When a character Is reversed all pixels that surround It are turned 
on. 

F. When typing In a new program It Is good practice to follow these 
steps: 

1. Type In the word NEW (then press the return key). 

2. Hold the RUN /STOP key down and hit the restore key (will clear 
the screen.) 

Inserting values Into epeclal memory locations may seem complex, 
but Is very easy to understand. Below Is a list of values for this 
purpose. 



COLOR VALUES 



Color 


Value 


Color 


Value 


Black 





Orange 


8 


White 


1 


Brown 


9 


Red 


2 


Light Red 


10 


Cyan 


3 


Dark Grey 


11 


Purple 


4 


Medium Grey 


12 


Green 


5 


Light Green 


13 


Blue 


6 


Light Blue 


14 


Yellow 


7 


Light Grey 


15 



MEMORY LOCATIONS 

POKE 53280,? (screen border location) 
POKE 53281 ,? (screen background location) 
POKE 646,? (cursor location) 

The question mark can be from zero to fifteen. Refer to the color 
chart above for the color you with to Input. As you can see there Is the 
word POKE preceding each number, the reason for this is that, you 
must give the computer a command before it can perform any function. 
When you wish to Insert a value Into any memory location, that value 
has to be POKEd there. Where you POKE a value In memory, it means 
the same as to insert it. Type In the following examples. 
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POKE 53280,0 (means place In memory location 53280 the value 0, 
which Is the color black) 

POKE 53281,1 (means place in memory location 53281 the value 1, 
which Is the color white) 

POKE 646,2 (means place In memory location 646 the value 2 which is 
the color red) 

Type In the program below and aher each line press the RETURN key 
to enter the program in memory. When all lines are typed In, type the 
word RUN and press the RETURN key. 

10 PRINT "WHAT EVER YOU LIKE" 
20 GOSUB 40:REM GOES TO LINE 40 

30 GET$:IF A$=" " THEN 10:REM PLEASE SEE EXPLANATION 
BELOW 

40 POKE646,N:N = N-M:IFN= 15 THEN N =1:REM PLEASE SEE 
EXPLANATION BELOW 

50 RETURN:REM RET-URNS TO L|NE AFTER GOSUB (LINE 30) 

EXPLANATION: Line 10 prints what ever Is between the quote marks. 
Line 20 goes to line 40. Line 40 puts the value of N in the character 
color memory location then N is incremented by one. Then If the 
statement keeps the counter from going over the value 15 because 
there are no color codes that are above that. Line 50 goes to line 30 and 
line 30 scans the keyboard for a key to be pressed. If no key Is pressed 
then the program goes to line 10 and prints what ever Is between the 
quote marks In the color that was returned by line 40. 

PROGRAMS THAT PRODUCE COLOR 

Type in the following programs and after each line press the 
RETURN key to enter the line Into memory. After all lines have been 
typed In type the word RUN and press the RETURN key. 

10 PRINT CHR$(147):REM CLEARS THE SCREEN 

20 INPUT "PLEASE CHOOSE A NUMBER FROM TO 15";A:REM 
ASKS FOR A NUMBER 

30 POKE53280,A:REM PUT IN MEMORY LOCATION 53280 THE 
NUMBER INPUT IN LINE 20 

40 GOTO 10:REM START OVER AGAIN 

EXPLANATION: Line 10 Is the character code to clear the screen. Line 
20 asks for a number to be Input from to 15. Line 30 puts the value of 
the color Input In line 20 in the border color memory location. Line 40 
sends the program back to line 10 to start the process all over again 
until the RUN /STOP and RESTORE keys are pressed. 
10 PRINT CHR$(147) 

20 INPUT BORDER COLOR CHOOSE A NUMBER TO 15";A 
30 POKE 53280. A: REM BORDER COLOR 
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40 FOR DELAY = 1 TO 1500:NEXT DELAY:REM THE COMPUTER 
COUNTS FROM 1 TO 1500 THEN CONTINUES 
50 PRINT CHR$(147) 

60 INPUT "BACKGROUND COLOR CHOOSE A NUMBER 
TO 15"; 8 

70 POKE 53281, B:REM BACKGROUND COLOR 
80 FOR DELAY = 1 TO 1500: NEXT DELAY 
90 GOTO 10: REM START OVER 

EXPLANATION: Line 10 clears the screen then line 20 asks for the 
border color to be Input. Line 30 puts the value that was Input from line 
20 In the color memory location for the border. Line 40 displays the 
border color In line 30 for a count of from 1 to 1500. Line 50 clears the 
screen then goes to line 60. Line 60 inputs a bacl<ground color then 
goes to line 70 which displays the baci<ground color chosen in line 60 
for a count of from 1 to 1500 that is in line 80. Line 90 goes to line 10 
and starts all over again. 

Please add or replace the following program lines to your last 
program. 

90 INPUT "CURSOR COLOR CHOOSE NUMBER TO 15";C 
100 POKE 646,C:REM CURSOR COLOR 
110 FOR DELAY = 1 TO 1500: NEXT DELAY 
1 20 GOTO 10: REM START OVER 

EXPLANATION: Line 90 will replace the old line 90, the new line 90 
will input a color value to be put in line 100 which displays the cursor 
color input from line 90. Line 110 displays the cursor for the county of 
from 1 to 1500 then goes to line 120 which returns to line 10 and starts 
all over again. You may want to save this program on disk or tape If so 
refer to the section on disk and tape functions. The basic function of the 
three most important color memory locations has been explained. 
Please type in the following In What Is called the immediate mode. To 
enter program line in memory, press the return key. 
FOR A = TO 1 STEP 0:POKE53280,4:POKE53280,6:NEXT 

EXPLANATION - Using the variable name A, start count at 0, end the 
count at 1 , counting In steps of 0. Put in memory location 53280 (border 
color) the color purple. The put In the same location the color yellow. 
The last instruction (next) continues to the next step, which will repeat 
{he process over and over again. Hint: Holding the CTRL ke/^down will 
slow the process down, and depressing the RUN /STOP key will halt 
execution. 



8 



Type each program line in tlien press the return key to enter it Into 
memory. After ail lines have been typed and entered Into memory, 
type the word RUN then press the RETURN key to execute each 
program below. 

5 PRINT CHR$(147):REM CLEAR SCREEN 

10 POKE53280,0:POKE53281,6 

15 PRINT "BYE! SEE YOU LATER" 

20 for 0= 1 to 1000: N€XT D: REM COMPUTER COUNTS TO 1000 
30 POKE53265, PEEK(53265) AND23g:REM WILL BLANK THE 
SCREEN WITH THE BORDER COLOR 
35 FOR b= 1 TO 1000:NEXT D 
40 PRINT CHR$(147) 

45 PRINT "HI! HERE I AM AGAIN:REM SEE EXPLANATION 
BELOW 

50 POKE53265, PEEK(63265) OR 16:REM TURN SCREEN BACK ON 

EXPLANATION - Line 6 prints chr$(147), which is the chr$ code for 
clear the screen. Line 10 pol<es color memory locations with the color 
values for a biacl< border coior and a blue background color. Line 15 
prints what is between the quotes. Line 20 Is a program delay used as a 
timer for the amount of time that line 15 will remain displayed on the 
screen. Line 30 pokes memory location 53265 (vie control register) with 
the value already there, then ands it with the value 239. This will cause 
the screen to change to the border color. Line 35 another delay that 
times the amount of time that the screen will remain blanked. Line 40 
clears the screen of what was printed on line 15. Line 45 prints the 
reverse S which is the CLR/HOME key, the reverse Q is the down 
cursor key. What this does is print line 45 10 lines down from the home 
position of the cursor. Line 50 or's the memory location 53265 with 
itself and the value 16. This line turns the screen back on. 

5 PRINT CHR$(147):REM CLEARS THE SCREEN 

10 PRINT "THE CORRECT TIME PLEASE (00HR:00MIN:00SEC)" 

20 INPUT Tl$ 

30 PRINT CHR$(147) 

40 PRINT " THE TiME IS > > > ";TI$:GOTO40 

EXPLANATION - Line 5 clears the screen. Line 10 prints what is 
between the quote marks. Line 20 inputs the tl$ function (the Jiffy 
clock). Line 30 ciears the screen of what was printed on line 10. Line 40 
Is printed 14 lines down and 7 spaces over. Also the time is printed to 
the screen and the goto 40 repeats the Instructions on line 40 over and 
over until the RUN /STOP key is held down while pressing the 
RESTORE key. stop the program execution. > 
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SOUND 



Programing sound on the Commodore can be very complicated. 
' Normaliy it is beyond the abiiity of most beginning computer owners to 
produce sound from the computer that would be the quality necessary 
to perform music. Please do not let this discourage those of you that 
wish to program your favorite song. There are many commercial 
programs on the market that can produce excellent music or sound 
synthesis you may wish to experiment with. Below you will see a 
program example, this program produces various types of sound. 
After typing on each line, press the RETURN key, to enter the line into 
computer memory. When you are finished entering the last program 
line, type the word RUN and press the RETURN key to execute the 
program. 

10 PRINT CHR$ (147):REIVI CLEAR THE SCREEN 

20 INPUT "SET VOLUME FROIVI LOWEST TO HIGHEST 15";A:REM 

SET VOLUME OF SOUND 

30 PRINT "TRIANGLESAWTOOTH:PULSE:NOISE" 
40 PRINT" 17 33 65 129" 

50 INPUT "SET WAVE FORM 1 7-33-65-1 29" ;B: REM CHOOSE FROM 
THE FOUR TYPES ON LINE 30 

60 INPUT "SET FREQUENCY CONTROL TO 127";C:REM SET SOUND 
FREQUENCY 

70 POKE5496,A:REM MEMORY LOCATION FOR SOUND VOLUME 
80 POKE54278.240:REM MEMORY LOCATION TO SUSTAIN THE 
LENGTH OF TIME THE SOUND WILL BE HEARD 
90 POKE54275.2:REM MEMORY LOCATION FOR THE PULSE WAVE 
FORM WIDTH 

100 POKE54276,B:REM MEMORY LOCATION THAT SELECTS TYPE OF 

WAVEFORM 

110 FOR F=1 TOO 

120 POKE54273,F+F:NEXT F:REM MEMORY LOCATION THAT 
CONTROLS SOUND FREQUENCY 

130 GETA$:iFA1+""THEN 110 

140 iFA$="R" THEN 250:REM IF THE R KEY IS DEPRESSED THAN 
GOTO LINE 250 

150 iFA$="Q" THEN 350:REM IF THE Q KEY IS DEPRESSED THEN 
GOTO LINE 350 

160 S=54272:REM START OF SOUND MEMORY LOCATIONS 
170 FOR 1=0 TO 28 

180 POKE S+1,0:REM PLACE THE VALUE ZERO IN THE MEMORY 
LOCATION 54272 

190 NEXT I 

200 RETURN 
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250 GOSUB 160:PRINT CHR$ (147):GOTO10 
350 GOSUB 160: PR I NT 

CHR$(147):POKE631,82:POKE632,85:POKE633,78:POKE198,3 

EXPLANATION - First line 10 clears the screen, then line 20 asks for a 
value from to 15. This value sets the volume for the sound that Is 
produced. LINE 30 through 50 asks for one of the four values that 
represent the type of wave form to be used. Line 60 asks for a value 
from to 127 that controls the sound frequency. Line 70 puts the 
value input In line 20 into the memory location that controls the 
volume. Line 80 puts the value 200 in the memory location that controls 
the amount of time that the sound Is sustained. Line 90 puts the value 2 
in the memory location that controls the pulse wave form width. Line 
100 puts the value Input In line 50 in the memory location that controls 
which of the four types of wave forms will be produced. Line 1 1 to 1 20 
is a FOR NEXT loop that Increments by one the value Input In the 
memory location that controls the frequency of the sound produced. 
This value will be Increased each time It goes through the loop, 
depending on the value that is input in line 60. Line 130 uses the GET 
statement to search the keyboard for a key to be depressed, If no key Is 
pressed then line 110 is executed again. The sound will continue to 
repeat until the R In line 140 Is pressed or the Q In line 150 is pressed. 
If the letter R is pressed, line 140 send the program to line 250. The 
GOSUB statement on line 250 has the program execute lines 160 
through 2(M). This puts a vlue of zero in all of the sound memory 
locations to reset them to normal. The the RETURN statement on line 
200 returns the program to execute the rest of line 250, which blears 
the screen and then starts the program over again. If the letter Q Is 
pressed, line 150 has the program go to line 350. Line 350 to execute 
the next statement. Chr$(147) clears the screen then the letters RUN 
are poked into memory locations 631 through 633, which are the 
locations that temporarily store characters typed in from the keyboard. 
After the characters R U N are put into memory, the value three Is put 
in the memory location :that controls the number of characters In the 
keyboard buffer. The purpose Is to print the word RUN ont he same 
line as the cursor is on, so that when the RETURN key is pressed the 
program will execute again. This Is only put in the program as an 
example of what can be done with these memory locations and has 
nothing to do with producing sound. 

NOTE: They excellent sound capabilities of the Commodore are made 
possllbe by the SID chip. The Commodore programer's refer- 
ence guide will give a more detailed description of program- 
ming the SID chip. 
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DISK AND TAPE FUNCTIONS 



There are two types x>f data storage for the Commodore, they are 
tape and disk. The cassette tape is the ieast expensive of the two. 
There are a number of manufactures that mari<et a tape recorder or 
disi< drive for the Commodore computer. The following list beiow will 

name a few: 

CASSETTE TAPE DISK DRIVE 

Commodore Commodore 
Cardco MSD 

Indus GT 

The tape recorder is a sequential device. It is only possible to read 
the tape from beginning to end. It does not have the ability to go 
backwards or skip around. There also Is no easy way to find out what Is 
on the tape without reading the entire length. The disk drive is a 
random access device. It has the ability to ready any part of the disk 
without reading from ti^e beginning first. 

THE INSTRUCTIONS BELOW ARE FOR TAPE (please read them 
carefully). 

To hook up the tape recorder Is quite simple. Take the cable on the 
back of the tape recorder and insert it In the back of the computer, right 
behind the 4, 5, and 6 keys. Please make sure that you line up the teeth 
correctly, do not use excessive force. Now the tape recorder Is ready to 
use. You should avoid using tapes that are over thirty minutes as they 
have a tendency to stretch, five to ten minute tapes are preferred. 

To load from tape means that your are transferring data from tape to 
the computer. After a load is completed you will see a ready prompt, 
after which you type In ( run ) and then your program will execute. 
STEP 1 . To load a program from tape first you must have a program 
on it. We will assume that a program is on the tape, first rewind the 
tape and reset the counter so that you have a reference point. Now type 
in the following: LOAD "PROGRAM NAME'M (then press the return 
key) (note the one Is the device number for the recorder and Is 
optional). 

STEP 2. Press the playbutton on your recorder ( the computer screen 
will prompt you to do-so(. The screen will go blank, and when it 
reappears you will see the message beiow: 
SEACHING FOR (program name) 
FOUND (program name) 

Press the Commodore key, lower left hand corner of the keyboard. The 
screen will go blank a short time then It will display the message 
LOADING. 

STEP 3. After the program has loaded the ready prompt will be 
displayed. You should now enter the word (run), to execute the 
program. 

To save to tape means that you are transferring data to the tape. 
STEP 1 . To save a program first we have to make one, please type in 
the program beiow: 

Type in the word (new) then press the return key. 
10 PRINT "ANYTHING YOU LIKE" (press return key) 
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20 END (press return key) 

STEP 2. Now that we have a program lets save It to tape. Please type 

in the following: 

SAVE "PROGRAM NAME", 1 (press return key) (note the one Is the 

device number for the recorder and Is optional) 

STEP 3. The screen wlH prompt you to press the play and record keys 

simultaneously, after the save Is completed the ready prompt should 

reappear. 

You can load and run a program by pressing the shift and run/stop 
keys simultaneously. Always remember to rewind the tape before any 
load Is to be executed. If load Is typed by Itself, then the first program 
found on the tape will be loaded. If you were to simply type save, then 
a program would be stored on the tape with no file name. There Is the 
verify command, which will verify that a saved program has been store 
properly. The verify command is executed by typeing VERIFY 
"PROGRAM NAME" and pressing the return key. If a verify error is 
displayed then the program has not been stored properly. Verify can 
also be used to find the end of a program, so that you may save a new 
program at the end of the proceeding program. Please follow the 
example below: 

STEP 1 . When you have a new program that is to be put on a tape with 
others type In VERIFY "PROGRAM NAME" (press return key). (Note 
use the name of the last program on the tape). 
STEP 2. While searching to verify the last program all others will be 
bypassed. A verify error will be displayed because the last program Is 
not the same as the one In the computers memory, but you will be at 
the end of the last program on tape. 

STEP 3. Now save your new program at this location on the tape. 



THE INSTRUCTIONS FOR THE DISK DRIVE 

To hook up the disk drive Is as simple as the tape recorder. The back 
of the disk drive has three sockets one at the bottom next to the on /off 
switch and two Identical sockets at the right hand corner. The socket by 
the switch is the power cord and should be plugged Into the same 
outlet as the computer. Take the black cord and plug one end in the 
back of the computer between the seven and eight keys, and plug the 
other end In either of the two upper right hand sockets. Because the 
disk drive is used more eten than the tape recorder, It will be explained 
in much more detail. The disk that Is inserted In the disk drive Is where 
the data Is stored. Data Is stored In the form of blocks which hold up to 
256 bytes information. There are 683 blocks on each diskette. The 
blocks are stored on tracks, there are 35 tracks on the Commodore disk. 
The drive has a program called the DOS (note disk operating system) 
this program keeps track of the blocks. It organized into a BAM (note- 
block allocation map) and a directory. The BAM and directory is stored 
on track 18 of the disk. When ever a program Is saved or a data file 
closed, on the disk, the BAM Is updated to show how many blocks are 
available. All data stored Is arranged in files, there are five types of 
files. The following is a list and explanation of the five types of files. 
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PROGRAM PRG 

RELATIVE REL 

.SEQUENTIAL SEQ 

USER USR 

DELETED DEL 



PROGRAM FILE: A program file is data that was saved as a program, 
it could be either a basic or machine language program. Program files 
are the only type of file that you can use the load command on. When 
the directory of the disk is loaded and then listed, the screen will 
display all of the files on the disk. After the file name there will be an 
abbreviation for every type of file. These are listed above. 

RELATIVE: A relative file is used to store data, all data records are 
numbered. This type of file is tougher to work with, but Is used best if 
there are a lot of files. Relative flies are accessed with the open 
command, but before reading this type of file you must set a pointer to 
zero In on a particular record. The relative file is faster to access data 
than a sequential file because of this. 

SEQUENTIAL: A sequential file Is something like a relative file, except 
all data has to be read from beginning to end. Because of this It is 
slower to use and takes up more computer memory. The sequential file 
Is easy to use because you are not required to set a pointer to any 
particular record. 

USER: A user file is a very special type of file. This type of file is used 
mostly as a form of protection. The user file can be treated as It were a 
sequential file. This type of file will be erased when the validate 
command Is executed. Programs that are wrote for the disk operating 
system will most likely have data stored in user files. 

DELETED: The deleted file is no longer stored on the directory and no 
blocks are allocated for It in the bam. This file still exists on the disk 
until the blocks formerly held by It are reallocated to a new file. When a 
file Is scratched from the disk It becomes a deleted file. 

THE STRUCTURE OF THE DIRECTORY 

Below is what a typical directory looks like: 
OltilimiMSillHH^^ 



2 "BOOT" PRG 

1 "MB1.0BJ" PRG 

131 "MB2.0BJ" PRG 

43 "EDITOR" PRG 



487 BLOCKS FREE 
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The directory Is a list of all files on the disk. There can be up to 144 
entries In the directory. To load a directory type the following 
L0AD"$",8 (press return i<ey) then type LIST (press return key). The 
top line Is the directory header. The first Item on the directory header 
Is the disk name then disk ID and last is the DOS version and format 
type. Beiow the directory header is a list of the files, first Item is a 
number which Indicates the size of the file, next Is the file name, 
following that Is the file type. The last Item on the directory displays 
how many blocks are still available on the disk. NOTE: After a 
directory has been listed. It is possible to load any file on the directory, 
by moving the cursor to the far left of the file that you wish to load. 
After you have done this, type LOAD, then move the cursor to the right 
of the last quote mark, type a comma, the number eight, and a colon. 
This will load any basic program file, but wlii not work on a machine 
language program, to load a machine language program type a comma 
after the eight leaving out the colon, then type the number 1. Please 
see the example beiow: 

"«ifS9MgHEWHHUBH"KeWtfl 



2 "BOOT" PRG 

LOAD "MB1.0BJ",8: PRG (Basic prg) 

LOAD "MB2.0BJ",8,1 PRG (Machine Language prg) 

43 "EDITOR" PRG 



487 BLOCKS FREE 



DISK COMMANDS 

FORMAT NEW DISK: : 

OPEN (flle#), (dlvice#),- (channei#):PRINT#, "N:NAME, ID" 

EXPLANATION - Open channel, flie# (can be any number from 1 tq 
255, number greater than 127 should be avoided, because they can 
generate unwanted linefeeds after the return character), the number 8 
is the device number for the disk drive, channel number can be any 
number from 2 to 15, channels 0' to 1 are reserved fqr the operating 
system (used for loading and saving), 2 through 14 are used for data to 
files, the command channel Is 15. The print# command directs data to 
the disk drive, n Is the abbreviation for new (this command is used 
when formatting a disk for the first time), the name can be up tq 
sixteen characters, this ID is two characters, In any combination oif 
fiiimbers, letters or both. 
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The format can be abbreviated as follows: 

OPEN15,8,15"N:NAME,ID" (press return key) 

After disk Is formatted the FILE that was open must be closed, using 

this statement: CLQSE15 (press return key).. 

HINT - If you already fiave a formatted disk and wish to reformat it. 

There Is a faster method than the standard format it Is as follows: 

OPEN15,8,15,"S:NAME" (press return key) 

SCRATCH A FILE: 

EXPLANATION - When a file Is scratched from the disk It Is erased. 
The procedure Is the same as to format, except that an S (scratch) is 
used Instead of the N (new), and the ID Is not used, it Is possible to 
scratch more than one file by using pattern matching, for example If 
there are two files and their names are test and track. You would type 
OPEN 15,8,15,"S:T*"« both programs would be erased. Another 
example of this technique, used on three files with the names, rats, 
bats, and cats would be as follows: 
OPEN15,8,15,"S:?ATS", this would erase all three files. 

RENAME A FILE: 

OPEN15,8,15,"R:NEW- NAME = OLD NAME" (press return key) 
(the rename command will now work with flies that are open) 

EXPLANATION - This Is very simple, the R stands for rename, if you 
have a file with the name planes and you want to change the name to 
airplanes, you would type the following, 0PEN1S,8,1S,"R: 
AIRPLANES = PLANES, (press return key). 
VALIDATE A DISK: 
OPEN15,8,15,"V" (press return key) 

EXPLANATION - When a disk has been used over a period of time, the 
directory can become disorganized. Usually this Is caused by repeated 
saving and scratching of flies. This usually results In one or more 
blocks on the disk that cannot be used because they are too small. The 
validate command will reorganize the disk to make the most out of the 
space that is available. 
INITIALIZE THE DRIVE: 
OPEN15,8,15,"r' (press return key) 

EXPLANATION - There will be times when the disk drive will not 
respond to your commands. This Is caused by an error condition. When 
the drive Is Initialized it will be returned to the same state as when first 
turned on. 

READING THE ERROR CHANNEL: 

10 OPEN15,8,1S 

10 INPUT"15,A$,B$,G$,D$ 

30 PRINT A$,B$,C$,D$ 

EXPLANATION - The basic routine above will read the error channel. 
The purpose of reading the error channel. Is to find out what type of 
error condition exists, if the red light on the drive starts to blink and the 
drive motor stops. Load and run the program above. The following is 
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an explanation of the program above: After opening a channel, 4 
variables are read and describes the error condition. The first variable 
Is the error number, the second is the error description, the third is the 
track number on which the error occurred, and the fourth is the block 
number of the track. Lastly the 4 variables are displayed on the screen. 

VERIFY: 

OPEN15,8,15,"V" (CHECKS CURRENT MEMORY AGAINST PRE- 
VIOUSLY SAVED FILE ON DISK) 

LOAD PROGRAM FILE: 

LOAD "PROGRAM" NAME, 8 (BASIC PROGRAMS) 

LOAD "PROGRAM NAME",8,1 (MACHINE LANGUAGE 
PROGRAMS) 

LOAD DIRECTORY: 

LOAD "$",8 (LOADS A DIRECTORY) 

LOAD "$",8 (LOADS THE DIRECTORY BUT ONLY LIST THE DISK 
NAME AND BLOCKS FREE) 

LOAD "$* = P",8 (LOADS DIRECTORY AND LISTS ONLY 
PROGRAM FILES) 

(SUBSTITUTE THE P FOR S (SEQ.) OR R (REL) FILES) 
SAVE PROGRAM FILE: 

SAVE "PROGRAM NAME",8 (ONLY BASIC PROGRMS CAN BE 
LOADED IN THIS MANNER( 

SAVE AND REPLACE: 

OPEN15,8,15"@0:PROGRAM NAME" (REPLACES A PROGRAM 
WITH THE SAME NAME WITH ONE IN MEMORY) 



List Command: 

List 100 (List line 100 only) 
List 100 (Lists line 100 through end of program) 
List 100-200 (Lists line 100 through 200) 
List 100 (List from start of program to 100) 
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SUMMARY OF DISK OPERATING SYSTEM [DOS] error messages 

NOTE: At times you wMI encounter error messages displayed on the 
screen while using the disk drive. The list below, gives the number and 



type of error. 





OK (no error exists) 


1 


Files scratched response (not an error condition) 


2-19 


Unused error messages (please Ignore) 


20 


Block header not found on disk 


21 


Sync character not found 


22 


Data block not present 


23 


Checksum error in data 


24 


Byte decoding error 


25 


Write-verify error 


26 


Attempt to write with write protect on 


27 


Checksum error In header 


28 


Data extends' Into next block 


29 


Disk ID. mismatch 


30 


General syntax error 


31 


Invalid command 


32 


Long line 


33 


invalid filename 


34 


No file given 


39 


Command file not found 


50 


Record not present 


51 


Overflow In record 


52 


File too large 


60 


File open for write 


61 


File not open 


62 


File not found 


63 


File exists 


64 


File type mismatch 


65 


No block 


66 


Illegal track or sector 


67 


Illegal system track or sector 


70 


No channels available 


71 


Directory error 


72 


Disk full or directory full 


73 


Power up message, or write attempt with DOS mismatch 


74 


Drive not ready 



For a complete description of the DOS error messages read pages 
53-56 of your disk drive user's guide. 
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POKE AND PEEK 

POKE (MEMORY LOCATION), (VALUE) 

EXPLANATION - The poke command Inserts a value In a decimal 
memory location. You will be unable to change the value of memory 
locations in ROM (read only memory), it Is only possible to change 
values In RAM (random access memory). The reason is ROM can only 
be rad from not wrote to. This command will be used In various ways, 
one of which Is to put a color value in memory. An example would be as 
follows: 

POKE 53280, (memory location for the border color) i (value 
for the color white), the result will be displayed on the screen as a 
white border. The memory location can be from through 65535, the 
value can be from to 255. 
PEEK (VALUE) 

EXPLANATION- The peek command reads from a memory location. 

This command is usually used in conjuctlon with the poke statement, 

but is not required. An example of the peek command is as follows: 

PEEK (204), will return a value of 0. This is the memory location for 

the cursor blink toggle, O=cursor on - 1 =cursor off. 

USES FOR POKE AND PEEK: Data storage, Sound generation. 

Loading assembly language routines in memory. Screen graphic 

displays. Modify the operating system parameters. 

MORE EXAMPLES: NOTE - Always use the decimal number when 

using the poke statement. 

A. POKE 144,0 (144 is the location that contains the kernal 
input/output status word value. Specific values will perform, varied 
status functions. If the status gets misdirected, the computer may 
respond with the device not present message. The normal value for 
this location Is 0, pokeing this value in location 144 should fix this 
problem.) 

B. POKE 145,127 (145 is the memory location than contains the status 
fllg for the STOP and RVS keys. The normal value for this location is 
255. A value of 127 will act the same as the RUN/STOP key.) 

C. POKE 160-162 (Locations 160 through 162 are the memory locations 
for the Jiffy clock. These locations act as a timer for the computer. A 
Jiffy is 1 /60 of a second. These locations will reset to zero by pokeing a. 
value of zero in ail three locations.) 

D. POKE 198,0 (198 *is the memory location for the number of 
characters In the keyboard buffer. The normal value for this location Is 
zero. It is possible to clear the buffer of any characters that it contains, 
by pokeing a value of zero here.) 

E. POKE 199,18 (199 is the memOryrlocation that controls the reverse 
character switch. The normal value for this Is 0. This value changes to 
18 when the reverse character mode is used (holding the CTRL key 
down and pressing the nine key). It Is possible to use this poke In a 
program to turn on reverse characters, but it most likely slower than 
using the RVS on and off keys.) 

F. POKE 209-210 (209-210 are the memory locations of the pointer for 
the current screen line address. Different values for these locations will 
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position the word output to the screen. Type and run the foilowing 

program for an exampie of this: 

10 POKE209,20 

20POKE210,7 

30 PRiNT "COMPUTER" 

G. POKE 211 (211 is the iocatlon that stores the number of spaces that 
are used on a printed line. A vaiue of 10 is equivalent to ten spaces. An 
example of this Is In the program below.) 

10POKE211,10 

20 PRINT "COMPUTER" 

H. POKE 212 (212 is the quote mode flag, a value of zero In this 
location will take you out of quote mode.) 

i . POKE 649,0 (649 is the memory location for the keyboard buffer. The 
normal value for this iocatlon Is 10. Using different values will change 
the number of characters the buffer can hold before it loses characters. 
Putting a zero in this location will disable the keyboard. If you hold the 
RUN /STOP down and press the RESTORE key, you will regain control. 
J. POKE 650,255 (650 Is the memory location that controls the 
repeating of certain keys. When the computer is first powered up, the 
value in memory location 650 is 0. Only the space bar, cursor keys^ and 
the insert/delete key will repeat. Any value from 64 to 127 will stop all 
keys from repeating. Values from 128 to 255 will make all keys repeat.) 
K. POKE 657, 128 (657 is the memory location that controls the 
function of switching from upper case to lower case. The normal value 
for this location is 0. To disable shifting from upper case to lower case, 
use the vaiue 128.) 

L. POKE 755,200 (779 is the list vector, the normal value of this 
location is 167. A vaiue of 200 will disable the list function.) 
M. POKE 788,52 (788-ls the interrupt request vector, value of 52 will 
disable the RUN/STOP key and also the Jiffy clock. A value of 59 will 
restore both.) 

N. POKE 808,239 (808 Is the kernai stop vector. The normal vaiue for 
this location is 237. Putting the vaiue 239 will disable the RUN /STOP 

key without stopping the clock.) 

0. POKE 808,225 (Disables the RUN/STOP and RESTORE keys. 

P. POKE 1024-2023 (These are the iocatlon where data is stored to be 

seen on the screen. To put a diamond In the middle of the screen you 

would poke 1524,90. The screen has 1000 locations.) 

Q. POKE 55296-56295 (These are the matching color locations, you use 

with the screen iocatins. if you poke, 55756,2 our diamond will turn 

red.) 

R. POKE 53272,23 (53272 is the memory location that controls the 
screen and character memory. A value of 23 will display in lower case 
characters. A value of 21 will convert it back to upper case. 
S. POKE 53280,8 (53280 is the memory location for the screen border 
color The values for this iocatlon are from to 15. The vaiue 8 will 
change the border color to orange.) 

T. POKE 53281,9 (53281 is the memory location for the screen 
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background color. The values for this memory location are from to IS. 
The value 9 will change the screen background to brown.) 
U. POKE 646,2 (646 Is the memory location for the cursor color. The 
values for this location are from to IS. A valueApf 2 will change the 
cursor color to red.) 

V. POKE S6341,0 (56341 Is a memory location that will control the 
speed at which the cursor will blink. The normal value for this location 
Is 57. A value of will cause the cursor to blink the fastest, and a value 
of 255 is the slowest.) 

IIVIPORTANT MEiy/IORY LOCATIONS: 

I . 43-44 (These addresses point to the start of basic text. This Is where 
a basic program begins. Basic text normally starts at $0801 
(hexideclmal) - 2049 (decimal). The hexideclmai and decimal answers 
are both the same location, but are calculated differently. Decimal 
numbers are counted in tens, hexideclmai numbers are counted In 
sixteenths.) 

EXAiy/IPLE: (1, 2, 3, 4, 5, 6, 7, 8, 9, A, b, C, D, E, F, 10) 

NOTE: ALWAYS USE DECIMAL NUIVIBERS FOR VALUES WHEN 
USING POKE AND PEEK FUNCTIONS. 

2. 55-56 (These addresses are the pointers for the highest memory 
location used by a basic program.) 

3. 57-58 (These addresses are the location where the current basic line 
number is stored.) 

4. 59-60 (These addresses are the location where the previous basic 
line number is stored.) 

5. 115-138 (These locations are a portion of the computers operating 
system, and since they are in RAM (random access memory,) they can 
be modified by the user.) 

6. 152 (This is the location that contains the number of open files, no 
more than ten files can be opened at one time. 

7. 153 (This is the iocatton that stores the input device default number, 
which is (keyboard.) 

8. 154 (this is the location that stores the CMD output device default 
number, which is 3 (screen). 

9. 186 (This location contains the value of the key, most recently 
pressed.) 

10. 197 (this location contains the value of the key, most recently 
pressed.) 

II. 206(This location contains the value for the character under the 
cursor, the normal value Is 32 (space). 

12. 213 (This location contains the value for the lenth of screen line, 
the normal value is 39.) 

13. 21 4 (This location contains the value for the vertical screen location 
of the cursor.) 

14.631-640 (These locations temporarily store characters typed from 
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the keyboard. NOTE: Used in conjunction with iocatlon 198, it is 
possible to enter characters the same as if they were typed from the 
iteyboard.) EXAMPLE: (POKE631,65:POKEig8,1 - this wili print the 
ietter A on the screen.) 

15. 648 (This location contains the character color value.) 

16. 647 (this location contains the value of the bacltground color under 
the cursor.) 

17. 852 (This location stores the value for the key repeat delay 
counter.) 

18. 653 (The value in this location corresponds to the following three 
keys, SHIFT, CTRL, and the Commodore. The value returned when 
the pressing the SHIFT key Is 1, the value for the CTRL key is 4, and 
the value for the COiy/IMOpORE key is 2. If all three are pressed simul- 
taneously the value is 7. There are many uses for this address one 
example would be the following: WAIT 653,1 ,0 - the program will stop 
until the SHIFT key is depressed, the after the 1 resets location 653.) 

19. 828-1019 (These locations are the buffer for the tape, this is the 
place where data is input first when loading from tape.) 

The memory locations listed, will prove to be a valuable resource, 
when programing or Just exploring the power of the Commodore 
computer. Please feel free to make use of these memory locations and 
their functions. The computer cannot be harmed by modifying the 
contents of these memory locations. The pages of this book contains 
many program examples of these memory locations, using a variety of 
techniques. Below is a list of some useful routines that can be executed 
using the system statement. 

MEMORY LOCATIONS OF ROUTINES: NOTE (The word SYS before 
each memory location, is the statement that will execute each routine.) 

1. SYS 58692 (Clears screen and homes the cursor.) 

2. SYS 64738 (Cold start reset, with screen power up message.) 

3. SYS 64760 (Faster cold start reset, with screen power up message.) 

4. SYS 64767 (Reset with no screen color change.) 

5. SYS 51712 (Warm start) 
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BASIC KEY WORDS 



Command Abbreviation Definition 

ABS A(SHIFTED B) - A numeric function that returns the absolute 
value of a number. 

AND A(SHIFTED N) Can be a logical operator that checks the 
truth between two expressions. 

ASC A SHIFTED S) A numeric function that gives the ASCII 

value of the first character in a string. 

ATN A(SHIFTED T) A mathematical function. 

CHR$ A(SHIFTED H) A string function that changes ASCII to a 

numeric value. 

CLOSE CL(SHIFTED O) A input/output statement that closes a 
channel to a device. 

CLR (C(SHIFTED L) A statement that resets all variables. 

CMD C(SHIFTED M) A input/output statement that outputs data 

to an opened device or file that corresponds to a file number. 

CONT C(SHIFTED O) A command statement that when used after a 

stop or end statement, will restart the flow of the program from that point. 

COS NONE A mathematical function. 

DATA D(SHIFTED A) String or numeric statements that are used 

in conjunction with the read statement. 

DEF FN D(SHIFTED E) A statement that is a used defined substitute. 
DIM D(SHIFTED I) A statement that defines the maximum range 
of an array or group of variables. 

END E(SHIFTED N) A Statement that stops a program from 

executing. 

EXP E(SHIFTED X) A mathematical function 

FOR F(SHIFTED O) A statement that sets up a variable as a 

counter, that is used in a for next loop. 

FRE F(SHIFTEDR) A statement that gives the amount of memory 

that Is free. 

GET G(SHIFTED E) A statement that scans the keyboard for a 
key to be key to be typed. 

GET# NONE A input/output statement that will input a 

character from a device or file. 

GOSUB GO(SHIFT S) A statement that will jump to a routine within' 
a program, used with the RETURN statement. 

GOTO G(SHIFTED O) A statement that will jump to a line within a 
program. (EXAMPLE: GOTO 10) 

IF THEN NONE A statement that sets up a conditional 

branch. (EXAMPLE: IF A$ = "Y" THEN SYS64738 (warm start)). 
INPUT NONE A statement that halts program execution, 

waiting for user input. (EXAMPLE: INPUT "WHAT IS YOUR NAME"; A$) 
INPUT# KSHIFTED N) A input/output statement that inputs data 
from a devivice or file. 

INT NONE Returns the interger value of a number. 

LEFT$ LE(SH I FTED F) A string function that returns a set number of 
characters from the left most end of a string, depending on the value given. 
(EXAMPLE:A$ = "UPDOWN":PRINT LEFTS (AS.2) display the 
word UP on the screen) 
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LEN NONE A interger function that counts the amount of 

characters in a specified string. (EXAMPLE: A$ = "COMPUTER":PRINT LEN 
(A$)-the result will be 8) 

LIST L(SHIFTED I) A command that lists a program in current 
memory. 

LOAD L(SHIFTED O) A command that loads a program from tape 
or disk. 

LOG NONE A mathmatical function. 

MID$ MSHIFTED I) A string function that returns the part of a 

string that is set by the first value, counting from the far left, the length of the 

second value. (EXAMPLE: A$ = "AROUNDTHEWORLD":PRINT 

MID$(A$,10,5)-the result of this would be the word WORLD.) 

NEW NONE a command that when used will erase a 

program currently in memory. 
NEXT N(SHIFTED E) A statement that is used in conjunction with 
the FOR statement, and serves as a counter that is incremented by 1, and 
tested for the end-value, to check to see if its time to stop the loop. 
(EXAMPLE: 10 FOR A = 1 T0 1000: NEXT A-this will count 1000 times before 
ending) 

NOT N(SHIFTED O) A logical operator that can be used to 
compare a set of values or variables, for a negative result. (EXAMPLE: IF NOT 
X = Y THEN END- the program will end if the value of x does not equall the 
value of y.) 

ON NONE A statement that is used with the goto and 

gosub statements. Depending on the value of a set of variables in a program, 
the ON statement will jump to any one of several predefined line numbers 
within the program. The ON statement can also be used inplace of the IF 
THEN statement. (EXAMPLE: ON A GOTO 10,20,30) 
OPEN 0(SHIFTED P) A command that will open a channel to a 
device or file. 

OR NONE A logical operator that can compare a set of 

values for a true of false result. (EXAMPLE: IF A =50 OR B = 1 00 THEN END- 
this means if A and B are true then end the program) 
PEEK P(SHIFTED E) Readsandreturnsthecontentsofaspecified 
memory location. (EXAMPLE: POKE 53280,1-put in location 53280 the value 
POKE P(SHIFTED O) Put a value in a specified memory location. 
(EXAMPLE: POKE 53280,1-put in location 53280 the value for color 1) 
POS NONE Returns the current cursor position. 

(EXAMPLE: 10 IF POS(O) = 10THEN END-when the cousor reaches position 
20 the program will end) 

PRINT ? A statement that is used to output data to the 

screen. This data can also be directed to the printer by using the CMD 
statement. (EXAMPLE: PRINT "COMPUTER") 

PRINT* P(SHIFTED R) A input/output statement that is used to 
output data to a device of file. (EXAMPLE: 0PEN1,4:PRINT#1, 
"C0MPUTER":CL0SE1 -results in printing the word COMPUTER to the 
printer) 

READ R (SHIFTED E) A statement that reads from a data 
statement. 1 READ A$ 

EXAMPLE — 2 DATA "DISK DRIVE" 
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REM NONE A statement that cannot be executed, but 

serves as vehicle to store remarks in a program. (EXAMPLE: 1 i=»RiNT 
"PRINTER":REM THIS IS LINE 1) 

RESTORE RE(SHIFTED S) A statement that resets the pointer to the 
first data statement in the program. This can be used to read the same data as 
manytimes as needed. (EXAMPLE: 1 READ A$ - reads the word TAPE twice) 

2 RESTORE 

3DATA"TAPE" 

RETURN RE(SHIFTED T) A Statement that is used to return to the data 
or line number following the gosub statement. 
(EXAMPLE: 1 GOSUB 3 - goes to line 3 then returns 

2 END — end on line 2) 

3 RETURN 

RIGHT$ R(SHIFTED I) A string function that returns a set number 
of characters from the right most end of a string, depending on the value 
given. 

(EXAMPLE: A$ = "SCREENCOLOR":PRINT RIGHT#(A$,5)-this will printthe 
word COLOR) 

RND R(SHIFTEDN) A floating point function that creates a 
random number. (EXAMPLE: PRINT IRND{0)*10-this will print a number 
from to 9) 

RUN R(SHIFTED U) A command that will execute a program that 
is in memory. 

SAVE S(SHIFTED A) A command that will store a program to tape 
or disk. 

SGN S(SHIFTED G) A INTERIOR FUNCTION 

SIN S(SHIFTED I) A FLOATING POINT FUNCTION. 

SPC( S(SHIFTED P) A function that will print a specified number 

of spaces across the screen. (EXAMPLE: PRINT SPC910)-will print 10 

spaces. 

SQR S(SHIFTED Q) A flosting point function that will return the 
square root of a specified value. 

STATUS ST A function that gives the condition of any 

input 01* output operation. 

STEP ST(SHIFTED E) A statement that works with the IF THEN 
statement. The STEP statement will increment the IF THEN function with a 
specified value. 

(EXAMPLE: FOR A = 1 TO 10 STEP 5-will loop twice) 

STOP S(SHIFTED T) A statement that will stop the execution of a 

program and print the line number from which STOP statement was 

executed. 

STR$ ST(SHIFTEDR) A string function that returns a string 
variable from a numeric variable. (EXAMPLE: T=4:T$=STR$(T)A$=*THE 
TIME IS "+T$+":00":PRINT A$-will print (THE TIME IS 4:00) 
SYS S(SHIFTED Y) A statement that will execute a memory 
location containing a machine language program or a kernal routine. 
(EXAMPLE: SYS 64738- will give a system cold start) 
TAB( T(SHITEDA) a function that acts like th SPC function, the 

TAB function should only be used with the 
PRINT statement, because it has no effect 
when used other-wise. 
TAN NONE A MATHEMATICAL FUNCTION. 
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TIME Tl Afunctionthatreadstheinternaltimerofthe 
computer also known as the jiffy clock. —(EXAMPLE: PRINT TI/30-this will 
display how many 1/30 second intervals have elapsed since power up) 
TIME$ Tl$ A function that will return a six character 

time display. (EXAMPLE: 1 Tl$ = 
"000000":FOR T = 1 TO 10000: NEXT 
T:PRINT Tl$-will display 000010) 
USR U(SHIFTED S) A function that accesses a user callable 
machine language routine. Memory locations 785 and 786 must contain the 
pointers for the start of the machine language routine. 
VAL V(SHIFTED A) A function that converts a string variable 
to a numberic. (EXAMPLE: A$ = "55": PRINT VAL (A$)-will print a 55) 
VERIFY V(SHIFTED E) A command that is used to compare a 
program currently saved to tape of disk with the same program in memory. 
(EXAMPLE: SAVE"TEST",8:VERIFY*TEST".8-will save and verify the 
program called test) 

WAIT W(SHIFTED A) A statement that stops the execution of a 
program until the specified condition is met. (EXAMPLE: WAIT 198,1-will 
stop until any key is pressed) 



FORMS OF PROGRAM PROTECTION: 

There are many types of protection that can be used on software. 
Protection of software may be new to some of you, I will explain a few 
simple techniques. FIRST, WHAT IS PROTECTION?: Most 
commercial software uses some form of protection, that Inhibit the user 
from making a copy or modification of their program. The most 
common forms of protection are listed below, with an explanation of 
what they do. There are so many types of protection, that It would be 
impossible to cover them all In Just a few pages. 
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TYPES OF PROGRAM-PROTECTION: 

1. UNLISTABLE PROGRAM LINES 

2. INVISIBLE PROGRAM LINES 

3. UNLISTABLE PROGRAM 

4. DISABLE KEYBOARD 

TYPES OF DISK PROTECTION: 

1. LOOP IN DISK DIRECTORY 

2. UNLISTABLE DIRECTORY 

3. INTENTIONAL DISK ERRORS 

PROGRAM PROTECTION: 

UNABLE TO LIST: 

10?"HI THERE":REML 

20 ?THIS WILL NOT BE LISTED":REML 

30 ?"NOR THIS":REML 

40 END 



EXPLANATION - When you try to list this program, you will get a 
syntax error. If you will notice the rem statement at the end of each 
line, has a graphic character after it. To produce this character hold 
down the SHIFT key and press the L key. The basic Interpreter cannot 
understand what the shifted L character does, so It will return a syntax 
error. It Is easy to overcome this problem by listing each line separately 
or moving the cursor to the line that create the syntax error, and 
pressing the return key. Now the line will be returned to normal. 
NOTE-THE QUESTION MARK IS SHORTHAND FOR THE PRINT 
STATEMENT. 

INVISABLE PROGRAM LINES: 

10 POKE 775,200:PRINT" 

20 ?"THE LINE ABOVE WILL BE HARD TO SEE" 

30 ?"ALSO IF THIS PROGRAM IS RUN, THE LISTING WILL BE 
UNREADABLE." 

40 END 

The program above lias two types of protection in line 10. The first Is 
a poKe statement that inserts a value of 200 In the list vector, disabling 
the list function, and second makes line 10 appear invisabie. After the 
poke statement, there is a colon, and then a print statement. After that 
there Is a quotation mark than a space, following Is the protection. Put 
another quotation mark after the space, then press the delete key to 
erase It. Now hold the SHIFT key down and then the DELETE key 
(marked INST/ DEL) down for a few seconds. You should see the cursor 
blinking fast, if you do not, retype the line 10 until you do. After you 
get the blinking cursor, release the SHIFT and DELETE keys. Last 
press the return key 2S times, you should see a reversed. Now enter 
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line 10 by pressing the return key. When the program Is run you will 
not be able to get a listing, and line 10 will be Invlsable. Actually line 
10 Is listed, and then deleted. If you look close, you will see It blink on 
the screenifor a very short time. To overcome this type of protection, 
line 10 can.^be deleted, providing it has no Information that is required 
for the program to operate. To make line 10 invlsable, the line has to be 
retyped, leaving out the deletes. NOTE-THIS TYPE OF PROTECTION 
CAN BE ANYWHERE IN YOUR PROGRAM. 
10 POKE808,225 
20 ?"ANYf:HING" 
30 GOTO 20 

EXPLANATION - After the program above has been run, and not 
before, you will be unable to stop It. This Is because, the poke In line 
10, disables the RUN /STOP and RESTORE keys. Also when you 
attempt to get a program listing it will be unreadable. 

DISK PROTECTION 

LOOPING DIRECTORY: 

The directory of a disk Is on track 18, all disk drive functions start 
with track 18. You will need a sector editor to view the data on a disk, 
sector editors can be found in the public domain, free of charge. The 
sector editor Is a program that is designed to view and modify the track 
and sectors of a disk. Disk doctor is a sector editor that Is in the public 
domain, and there are many more commercial sector editors on the 
market. I would suggest that you acquire this type of software, if you 
plan to do much work with the disk drive. Assuming you have a sector 
editor, load and run It. insert a disk that has programs on it, please be 
sure that you have a backup of this disk. In the event that you make a 
mistake, and destroy it. You should see a prompt, requesting which 
track and sector you want to view. Enter track 18 sector 1 , you should 
see a display similar to the one on page 30. Enter track 18 Sector 1 , you 
should see a display sirinliar to the one on page 40. The first two bytes 
12 and 04, they are the pointers to the next block and sector. The 12 Is 
the hexidecimal equivalent of the decimal number 18, which is track 
18, and 04 is sector 04. These first two bytes are the pointers to the 
next sector that has flies stored on it. If this was the last sector of the 
directory file the two bytes would be the hexadecimal 00 FF, meaning 
that this is the end of the director files. The number of sectors that are 
used for the directory depends on how many programs are on the disk. 
To put a loop in the directory we will change the first two bytes on the 
last sector of the directory file from 00 FF to 12 01 (hexidecimal for 18 
01). l-iavlng done this the disk drive will search in vain for the last 
sector on the directory file. This will not prevent programs on the disk 
from loading and running, only from listing the directory. 

DIRECTORY FIX: 

To fix a directory that has a loop, find where the first two bytes point to 
track 18 sector 01 . Then change them to the hexadecimal numbers 00 
FF. Now the directory is back to normal. 
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UNLISTABLE DIRECTORY: 

Load and run your sector editor, go to track 18, sector 00. Each byte is 
two numbers long (example) 12, now count the bytes on track 18 sector 
00. Bytes 144 through 461 contain the name of the disk, change the 
first six bytes to 14, 14, 14, 00, 00, 00. Now the directory Is unllstable, 
change the six bytes back to what they were before to have a directory 
that lists. 



DISK ERRORS: 

One of the most used forms of protection consist of putting intentional 
errors on the disk. A list and description of these errors is below. 

1 . 20 (Read error, the disk drive Is unable to locate the data block 
header). 

2. 21 (Read error, the disk drive Is unable to find a syn mark oh the 
track.) 

3. 22 (Read error, the disk drive has been told to read or verify a data 
block that was not written correctly.) 

4. 23 (Read error, the disk drive has found a checksum error In a data 

block.) 

5. 27 (Read error, the disk drive has found a checksum error In 
header.) 

6. 29 (Disk ID MISMATCH) 

It works like this, first the program on the disk has a routine that 
checks for a particular error condition on the disk. Then the read/write 
head of the disk drive is sent out to a specified track and sector to check 
If this error is present. If the error is not present the program is 
directed to crash. The protection routine below can be used in your 
software. 

10000 T = 1:S = 1 

10001 OPEN 15,8,15, "'IO":REM OPEN ERROR CHANNEL AND 
INITIALIZE DRIVE 

10002 OPEN 8,8,8:REM OPEN CHANNEL FOR DATA 

10003 PRiNT#15, "U1?:8,0";T;S:REM BLOCK READ* USING 
CHANNEL 8, DRIVE 

10004 INPUT#15,A$,B»,C$,D$: REM READ ERROR CHANNEL 

10005 CLOSE8:CLOSE15:REM CLOSE ALL FILES 

10006 IF VAL(A$)<>23 THEN 64760:REM IF ERROR VALUE NOT 
PRESENT THEN RESET 

10007 RETURN: REM RETURN TO START OF PROGRAM 
Amend this subroutine to your program. Then use a gosub statement 
to check for an error on the disk. Next you have to create an error 23 on 
the disk using a routine out of the book INSIDE THE COMMODORE 
DOS by RICHARD IMMERS AND GERALD G. NEUFELD. If this is 

. not available MEGASOFT LTD. markets a program that will put any 
type of error on your disk. 
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